CallAdjustMarksProc

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODSemanticInterface

CallAdjustMarksProc
The CallAdjustMarksProc method unmarks a series of objects that were previously marked.
void CallAdjustMarksProc (in ODPart thePart,
                          in ODSLong newStart,
                          in ODSLong newStop,
                          in ODOSLToken markToken);
thePart
A reference to the part associated with this semantic interface object.
newStart
The index that specifies the new beginning of the entries that are to remain marked.
newStop
The index that specifies the new end of the entries that are to remain marked.
markToken
A reference to the OpenDoc token to be used for unmarking the elements.

DISCUSSION
OpenDoc calls this method, when it is in the process of resolving an object specifier, to unmark a series of objects that were previously marked by a call to the CallMarkProc method. The newStart and newStop parameters indicate the beginning and end, respectively, of the range of marked objects that are to remain marked. Your override of this method should iterate over the remaining objects and unmark them. Your override of this method should use the markToken parameter to identify the marked objects in the iteration.
Before OpenDoc can call this method, you must call your semantic interface object's SetOSlSupportFlags method and specify the flag kAEIDoMarking to indicate that your semantic interface supports marking. In general, your part should override the CallGetMarkTokenProc, CallMarkProc, and CallAdjustMarksProc methods in the following cases: it already supports the marking of objects or it expects to deal with large numbers of records that might not all fit into memory at once.
Your override of this method is responsible for deallocating any structures for the previously marked objects that were allocated by your CallMarkProc method. If your part's semantic interface supports the marking of objects, it should also supply a token disposal method to dispose of your mark token.

EXCEPTIONS
The Apple Event Manager may throw an exception if this method is unable to adjust the marks as requested.
This method may throw platform-specific exceptions.

SEE ALSO
The ODSemanticInterface::CallDisposeTokenProc method (page 589).
The ODSemanticInterface::CallGetMarkTokenProc method (page 592).
The ODSemanticInterface::CallMarkProc method (page 593).
The ODSemanticInterface::SetOSLSupportFlags method (page 599).
The ODOSLToken class (page 456).